Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Lightning installation instructions improvements #848

Closed

Conversation

isaacdevlugt
Copy link
Contributor

Context: Our installation instructions are unclear for users.

Description of the Change: Point to pennylane.ai/install where possible.

Benefits: Better installation instructions and more clarity for users.

Possible Drawbacks: Hopefully none.

Related GitHub Issues:

@isaacdevlugt isaacdevlugt marked this pull request as ready for review August 12, 2024 19:44
@mlxd
Copy link
Member

mlxd commented Aug 12, 2024

Hey Isaac, we should wait until #832 is merged before tackling anything here, as the instructions may differ again.

Copy link

codecov bot commented Aug 12, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 73.74%. Comparing base (c6b86a5) to head (e32f68c).
Report is 2 commits behind head on master.

❗ There is a different number of reports uploaded between BASE (c6b86a5) and HEAD (e32f68c). Click for more details.

HEAD has 18 uploads less than BASE
Flag BASE (c6b86a5) HEAD (e32f68c)
25 7
Additional details and impacted files
@@             Coverage Diff             @@
##           master     #848       +/-   ##
===========================================
- Coverage   97.85%   73.74%   -24.11%     
===========================================
  Files         113       17       -96     
  Lines       18160     1916    -16244     
===========================================
- Hits        17770     1413    -16357     
- Misses        390      503      +113     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@isaacdevlugt
Copy link
Contributor Author

Hey Isaac, we should wait until #832 is merged before tackling anything here, as the instructions may differ again.

If we're doing this just to avoid merge conflicts, all good! Just want to make sure though that the scope of this PR doesn't cover source installation for anything 👍. All good on my side to wait for #832

README.rst Outdated Show resolved Hide resolved
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Instead of having installation instructions replicated in the README and docs, perhaps we could just make the README instructions very briefly redirect to the docs installation

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the README instructions provide what's in the installation page (e.g.,

.. include:: ../../README.rst
)

Copy link
Member

@josh146 josh146 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @isaacdevlugt! Good from my end, although will defer to the perf team for technical review.

README.rst Outdated Show resolved Hide resolved
README.rst Outdated Show resolved Hide resolved
README.rst Outdated Show resolved Hide resolved
.. code-block:: console

$ pip install pennylane-lightning[kokkos]
On most Linux systems, Lightning-Kokkos can be installed via Spack or Docker by following our installation instructions at `pennylane.ai/install <https://pennylane.ai/install/#high-performance-computing-and-gpus>`_.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

with lightning.kokkos, I believe there may be more cases than qubit/gpu where you need to install from source (e.g., if you want to use GPUs)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks! Does this sentence need to be modified 🤔?

README.rst Outdated Show resolved Hide resolved
@isaacdevlugt
Copy link
Contributor Author

Will be moving these changes to #851

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants